Inside Macintosh: QuickDraw GX Graphics /

Chapter 6 - Picture Shapes / Picture Shapes Reference

Functions / Drawing Pictures

GXDrawPicture

You can use the GXDrawPicture function to draw a picture without encapsulating the items of the picture geometry in a picture shape.

void gxDrawPicture(long count, const gxShape shapes[], 
                   const gxStyle styles[], const gxInk inks[],
                   const gxTransform transforms[]);

count

The number of picture items in the new picture shape.

shapes

An array of references to the shapes you want to draw.

styles

An array of references to the style objects you want to use to override the styles of the shapes specified in the shapes parameter. You may provide nil for this parameter if you do not want any overriding styles.

inks

An array of references to the ink objects you want to use to override the inks of the shapes specified in the shapes parameter. You may provide nil for this parameter if you do not want any overriding inks.

transforms

An array of references to the transform objects you want to use to override the transforms of the shapes specified in the shapes parameter. You may provide nil for this parameter if you do not want any overriding transforms.

DESCRIPTION

The GXDrawPicture function allows you to draw a picture without having to create a picture shape yourself. Instead, you specify the items of a picture geometry using the shapes, styles, inks, and transforms parameters.

The GXDrawPicture function creates a temporary picture shape using the values specified in these arrays, and draws the picture shape using the GXDrawShape function. The GXDrawPicture function calls the GXNewPicture function to create the temporary picture shape.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
shape_is_nil
inconsistent_parameters	(debugging version)
parameter_out_of_range	(debugging version)
index_is_less_than_one	(debugging version)
count_is_less_than_one	(debugging version)
cannot_set_item_shapes_to_nil	(debugging version)
cannot_use_original_item_shapes_when_growing_picture
	(debugging version)
Warnings
index_out_of_range
count_out_of_range
picture_expected	(debugging version)
shape_access_not_allowed	(debugging version)
picture_cannot_contain_itself	(debugging version)
cannot_dispose_locked_tag	(debugging version)
cannot_dispose_default_shape	(debugging version)
cannot_dispose_default_style	(debugging version)
cannot_dispose_default_ink	(debugging version)
cannot_dispose_default_transform	(debugging version)
cannot_dispose_default_colorProfile	(debugging version)

SEE ALSO

For information about picture items and their overriding styles, inks, and transforms, see "About Picture Shapes" beginning on page 6-3.

For an example using this function, see "Creating and Drawing Picture Shapes" beginning on page 6-27.

To encapsulate a picture geometry in a picture shape, use the GXNewPicture function, described on page 6-57.

To draw a picture shape, use the DrawShape function, described in the "Shape Objects" chapter of Inside Macintosh: QuickDraw GX Objects.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help